

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Version Control Configuration [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Version Control,Version Control Configure In Subversion,Subversion,Subversion Configure Version Control,Configure,Configure Version Control, Subversion">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Version Control Configuration</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="using_subversion_with_enterpri.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="tortoisesvn.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_BodyText"><span class="f_BodyText">This topic assumes that you have already installed Subversion (both the server and the client parts), and that you have a <a href="createalocalworkingcopy.htm">local working copy</a>, derived from a <a href="creatinganewrepositorysub_.htm">repository sub-tree</a>, already set up for use with your Enterprise Architect model. If this is not the case, please see the </span><span class="f_BodyText" style="font-style: italic;"><a href="settingupsubversion.htm">Set up Subversion</a></span><span class="f_BodyText"> topic.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Once you have set up and tested the Local Working Copy, you are ready to define a Version Control configuration for use with the Enterprise Architect model to place under version control.</span></p>
<p class="p_BodyText"><span class="f_BodyText">To apply version control to your Enterprise Architect model using the Subversion working copy that you have set up, follow the steps below:</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">Launch Enterprise Architect and open the model for which this Working Copy was created.</span></li>
<li value=2><span class="f_NumberedList">Select the </span><span class="f_MenuKeyField">Project | Version Control | Version Control Settings</span><span class="f_NumberedList"> menu option.</span></li>
<li value=3><span class="f_NumberedList">Click on the </span><span class="f_MenuKeyField">New</span><span class="f_NumberedList"> button</span><span class="f_NumberedList">, enter a suitable name in the </span><span class="f_MenuKeyField">Unique ID</span><span class="f_NumberedList"> field, then click on the </span><span class="f_MenuKeyField">Type: Subversion</span><span class="f_NumberedList"> radio button.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="dlgvcconfigssvn.png" width="532" height="664" border="0" alt="DlgVCConfigsSVN"><br>
<span class="f_NumberedList">&nbsp;</span></li>
<li value=4><span class="f_NumberedList">To the right of the </span><span class="f_MenuKeyField">Working Copy path</span><span class="f_NumberedList"> field, click on the </span><span class="f_MenuKeyField">Select Path</span><span class="f_NumberedList"> button and select the local folder in which to keep local working copies of the XML files to be stored in the Version Control repository.</span></li>
<li value=5><span class="f_NumberedList">In the </span><span class="f_UIControl">Workstation Settings</span><span class="f_NumberedList"> panel, click on the </span><span class="f_MenuKeyField">Select Path</span><span class="f_NumberedList"> button to specify the path for your Subversion client executable.</span></li>
<li value=6><span class="f_NumberedList">Click on the </span><span class="f_MenuKeyField">Save</span><span class="f_NumberedList"> button to save the configuration you have defined; the new configuration is added to the </span><span class="f_UIControl">Defined Configurations</span><span class="f_NumberedList"> list.</span></li>
</ol>
<div style="text-align: left; text-indent: -21px; padding: 0px 0px 0px 0px; margin: 5px 0px 0px 48px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">A new entry is also created in the <a href="localpathdlg.htm">Local Paths</a> list, with the same ID as the new version control configuration. The </span><span class="f_MenuKeyField">Local Path</span><span class="f_TiporNoteText"> entry records the Local Project path, for use in subsequent path substitutions.</span></p>
</td>
</tr>
</table>
</div>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=7><span class="f_NumberedList">When you have finished defining your version control configurations, click on the </span><span class="f_MenuKeyField">Close</span><span class="f_NumberedList"> button.</span></li>
</ol>
<p class="p_SubHeadingL2"><span class="f_SubHeadingL2">Additional Information on the dialog fields:</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="188" bgcolor="#e3e6ed" style="width:188px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Option</span></p>
</td>
<td valign="top" width="632" bgcolor="#e3e6ed" style="width:632px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Use to</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="188" style="width:188px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">This model is private</span></p>
</td>
<td valign="top" width="632" style="width:632px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Specify whether all users connect to a single shared copy of the model (e.g. a DBMS) or each user connects to their own private copy of the model.</span></p>
<p class="p_Tabletext"><span class="f_Tabletext">When unselected (for shared models), the option disables the </span><span class="f_Tabletext" style="font-weight: bold;">File History - Retrieve</span><span class="f_Tabletext"> functionality when the selected package is checked out by another user. This prevents modifications that might have been made by the other user from being discarded through importing a prior revision from version control.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="188" style="width:188px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Save nested version controlled packages to stubs only</span></p>
</td>
<td valign="top" width="632" style="width:632px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Set nested version controlled packages to stubs or fully expanded trees. Defaults to selected.</span></p>
<p class="p_Tabletext"><span class="f_Tabletext">For a full explanation of this option, see the </span><span class="f_Tabletext" style="font-style: italic;"><a href="usingnestedversioncontrolp.htm">Using Nested Version Control Packages</a></span><span class="f_Tabletext"> topic.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="188" style="width:188px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Unique ID</span></p>
</td>
<td valign="top" width="632" style="width:632px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Specify a configuration name that readily distinguish this configuration from other configurations. The Unique ID displays as a selection in the list of Version Control configurations a package can connect to. In addition you can select a previous version control configuration from this drop-down menu, providing the configuration is not in the current model.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="188" style="width:188px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Working Copy path</span></p>
</td>
<td valign="top" width="632" style="width:632px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Specify the folder where the XML files representing the packages are stored. This folder should already exist before it is specified here.</span></p>
<p class="p_Tabletext"><span class="f_Tabletext">Every PC using Subversion version control should have its own Subversion working copy folder in which to store working copies of the XMI package files; this should not be a shared network folder. Particularly bear this in mind if you are creating a .EAP file that is to be shared (e.g. a SQL database).</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="188" style="width:188px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Subversion Exe Path</span></p>
</td>
<td valign="top" width="632" style="width:632px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Specify the full path name of the Subversion client executable file.</span></p>
</td>
</tr>
</table>
</div>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">Sparx Systems strongly urge you not to manipulate version controlled package files outside of Enterprise Architect. It is possible to leave the package files in a state that Enterprise Architect cannot recognize.</span></p>
</td>
</tr>
</table>
</div>




            </div>
          </div>
        </div>



</div>


</body>
</html>
